home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d22 / menumast.arc / MENUMAST.DOC < prev    next >
Text File  |  1989-07-02  |  24KB  |  518 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 MENU-MASTER
  6.  
  7.  
  8.  
  9.            Menu Utility for the IBM PC, XT, AT and Compatibles
  10.  
  11.                                     by
  12.  
  13.                      Micro-Baron Software Products Div.
  14.                             Blue Caboose Systems
  15.  
  16.                               (513) 398-3957
  17.                      (513) 398-0928  BBS Support Line
  18.  
  19.  
  20.  
  21.                 Programs and Manual Copyright (C) 1986,1989
  22.  
  23.                                     by
  24.  
  25.                        Micro-Baron Software Products
  26.                                 P.O. BOX 9
  27.                               Mason, OH 45040
  28.  
  29.                                  June, 1989
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                              TABLE OF CONTENTS
  37.  
  38.  
  39.  
  40.             Topic                                           Page
  41.  
  42.      License and Copyright                                   3
  43.  
  44.      Limited Warranty                                        3
  45.  
  46.      Menu-Master Description                                 4
  47.  
  48.      Operating Requirements                                  4
  49.  
  50.      Getting Started                                         4
  51.  
  52.      The AUTOEXEC.BAT file                                   5
  53.  
  54.      Configuration and Name Changes                          5
  55.  
  56.      Color  Choices                                          7
  57.  
  58.      Specifying Pathnames and Applications                   8
  59.  
  60.      Exiting to DOS                                          9
  61.  
  62.      Operational Notes                                       9
  63.  
  64.      User Registration & Comments                           10
  65.  
  66.  
  67.                            STATEMENT OF LICENSE
  68.  
  69. The purchase and installation of this software obligates the user/purchaser
  70. to abide by United States Copyright Law, as interpreted and governed by the
  71. laws of the State of Ohio.  You are authorized to make one (1) archival
  72. copy of the registered version of this software for the sole purpose of
  73. protecting your investment from loss, and to freely share this shareware
  74. system as received with other users as long as no fees are charged for it.
  75. Menu-Master version 2.5 is distributed as User Supported Software for a
  76. suggested donation of $29.00, however, all rights are reserved by the
  77. author.  The corporate site license agreement allows unlimited copies to be
  78. made for use within a single corporation.
  79.  
  80.                                 COPYRIGHTS
  81.  
  82. This manual from time to time and place to place may make reference to
  83. programs or machines that somebody else thought of.  It is therefore
  84. legally prudent to include a list of those nice folks who were smart enough
  85. to think of things before we were.
  86.  
  87. IBM and PC-DOS are trademarks of International Business Machines Corp.
  88.  
  89. MS-DOS and Multiplan are registered trademarks of Microsoft Corporation.
  90.  
  91. Lotus 1-2-3 is a registered trademark of Lotus Development Corp.
  92.  
  93. Sidekick is copyrighted by Borland International, Inc.
  94.  
  95. PC-MOS is a trademark of The Software Link.
  96.  
  97.  
  98.                        STATEMENT OF LIMITED WARRANTY
  99.  
  100. SPECIAL NOTICE should be taken that Micro-Baron Software (the "author")
  101. reserves the right to make improvements in the product described in this
  102. manual, at any time, without prior notice, and without obligation to pro
  103. vide or notify users of the improved product.  Licensees of prior versions
  104. may upgrade to the latest version at a nominal cost.  The Author's products
  105. are distributed on as "as-is" basis.  The licensee assumes the entire
  106. risk as to the quality and performance in his or her own operating environ
  107. ment.
  108.  
  109. The Author warrants, to the original purchaser of registered copies only,
  110. that the magnetic media (if any) on which the programs are recorded will be
  111. free from defects in material and workmanship under normal use, service and
  112. conditions for a period of ninety (90) days from the date of receipt.  If a
  113. defect in the media should occur during this period, the media may be
  114. returned to Micro-Baron Software or its authorized or designated dealer or
  115. representative for repair or replacement without charge.  The above
  116. warranty for goods is made in lieu of all other express warranties, and no
  117. implied warranties or merchantability and fitness for a particular purpose
  118. or any other warranty obligation on the part of Micro-Baron Software shall
  119. last longer than ninety (90) days.  At no time will Micro-Baron Software or
  120. anyone else who has been involved in the creation, production and
  121. distribution of this software program be liable for indirect, special or
  122. consequential damages, such as, but not limited to, loss of anticipated
  123. profits or benefits resulting from the use of this program or arising out
  124. of any breach of this warranty.
  125.  
  126.  
  127.  
  128.                             PROGRAM DESCRIPTION
  129.  
  130. MENU-MASTER is a general purpose menu utility designed to allow easy access
  131. to up to 12 day to day applications and built in DOS functions on a fixed
  132. disk PC, PC-XT, AT, 386 or Compatible.  Instead of changing directories and
  133. constantly searching for application names, commonly used applications may
  134. be defined in terms that are meaningful to the user and Menu-Master worries
  135. about where it is.  Date Changes and Directory viewing are supported from
  136. within the menu system, which is designed to be loaded automatically
  137. through an AUTOEXEC file.  Menu-Master is configured (through a menu selec
  138. tion of course) by defining an English Language application name and a cor
  139. responding DOS path and program name combination.  The DOS Path Command is
  140. fully supported.  The Configuration program features a context sensitive
  141. HELP Function, and the Configuration page may be password protected to
  142. avoid unauthorized changes.  The menu name itself is user-defined, as is
  143. the sub-function menu.  The name "Menu-Master" does not appear anywhere in
  144. the screen area.  The screen may be defined in color or black and white
  145. using the Basic color codes as defined in IBM's Basic Manual and/or Guide
  146. to Operations, and further on in this manual.
  147.  
  148.                           OPERATING REQUIREMENTS
  149.  
  150. MENU-MASTER requires the use of PC-DOS or MS-DOS version 2.0 or greater.
  151. It may be used with multiple volumes of fixed disk, or a single 5 megabyte
  152. disk.  It may even be used with floppy based systems, although their lim
  153. ited storage will limit the number of programs available via the menu.
  154.  
  155.                               GETTING STARTED
  156.  
  157. Menu-Master's logical use is as a main program selector when first turning
  158. on your PC.  It may also be used as a sub function menu under any directory
  159. on your system.   To get going at first, let's assume that you will be
  160. starting from the Root Directory.  Return there if not there already by
  161. issuing a DOS Change Directory Command to the Root Directory as follows:
  162.  
  163. C>CD \ [Return]
  164.  
  165. Insert the Menu-Master diskette in floppy drive A: and type:
  166.  
  167. C>COPY A:*.* [Return]
  168.  
  169. The program, user definition and help files will be transferred to your
  170. root directory.  If you already have an AUTOEXEC.BAT file set up to set
  171. your clock or perform other housekeeping functions, you will have to add
  172. the following line as the last line in the AUTOEXEC.BAT file using EDLIN or
  173. another editor of your choice.  Simply add the word MENU or MENU.BAT to
  174. the AUTOEXEC.BAT file.  Since Menu-Master builds its own batch files to
  175. call your applications and return to itself, you should remove any lines in
  176. the AUTOEXEC file which call other programs.  The exceptions to this guide
  177. line are programs which are of the Terminate & Stay Resident (TSR) variety,
  178. such as various SETCLOCK routines, SK for Sidekick, network loading, etc.
  179.  
  180.  
  181. To install Menu-Master as a Sub-Directory menu, you must set the default
  182. directory the one you wish to set up the menu for.  For example, if you
  183. have a directory named "APP" with sub-programs to be called via Menu-
  184. Master, change to the APP directory with the following command:
  185.  
  186. C>CD \APP [Return]
  187.  
  188. Now copy all the menu files from the root directory by typing:
  189.  
  190. C>COPY \MENU *.* [Return]
  191.  
  192. Before leaving the subdirectory, configure this copy with names and a valid
  193. "return to" directory in Configuration Page item #19.  You may wish to
  194. return to the Root Directory Menu or to the Sub-Directory Menu.  You may do
  195. either, so the choice is yours.  If you are working with multiple hard
  196. drives, or a single drive with multiple partitions, be sure to include the
  197. drive letter in Configuration Page Item #19, along with the directory to
  198. return to.  This will insure that you will return to the menu on the same
  199. drive that you started with.  Start the menu by typing:
  200.  
  201. C>MENU [Return]
  202.  
  203. Some sample application names will be presented as examples.  It will be
  204. helpful to display the Configuration Option Screen while reading the next
  205. section on configuring your Menu-Master System.  Enter the Configuration
  206. module by typing:
  207.  
  208. [F-2] to bring up the DOS Menu on the right side of the screen, and:
  209.  
  210. 1        to load the Configuration Module (Change Menu Names).
  211.  
  212.  
  213.                            THE AUTOEXEC.BAT FILE
  214.  
  215. Since Menu-Master provides access to DOS commands through its menu, DOS
  216. itself must have a way to find these commands.  If you store your DOS com
  217. mands in a separate DOS Directory then the AUTOEXEC file should include the
  218. following as a requirement for your menu system.
  219.  
  220. PATH C:\DOS;  (or the name of your DOS directory)
  221. MENU.BAT
  222.  
  223. If your DOS command library is included in your Root Directory, which is
  224. not recommended, you may omit the PATH reference to \DOS.
  225.  
  226.  
  227.                   CHANGING THE MENU NAMES (CONFIGURATION)
  228.  
  229. The first thirteen lines (numbered 1 through 13) on the very left side of
  230. the Configuration Page are the application names that are presented on the
  231. menu.  Items 1 through 6 are for Application selections 1 through 6.  Item
  232. 7 is the Name of the sub-menu, presented on the right side of the screen,
  233. where the applications defined as numbers 8 through 13 are displayed as
  234. menu options 1 through 6.  Any of the numbered items may be replaced
  235. through 6.  Any of the numbered items may be replaced with your own defini
  236. tions by selecting the number to change and following the on-screen
  237. prompts.  For your convenience, the meanings of each group of numbers is
  238. presented in the on-screen help function, which is made available by typing
  239. "H" for "Help" or by touching [F-1] .  If you are following along in the
  240. program, try it now.  Pressing any key from the Help screen will return you
  241. to the Configuration Page.
  242.  
  243. The exact usage of all of the fields in the configuration page are as fol
  244. lows:
  245.  
  246. 1  -  6  User defined application names for main menu presentation.
  247. 7        Secondary menu name which appears as main menu item 7.
  248. 8  - 13  Secondary menu displays 1 through 6.
  249. 15 - 16  DOS Command descriptions which appear as DOS Menu Display items 5
  250.          and 6.
  251. 17       Chirp ON or Chirp OFF and "12" or "24" hour clock .  The word
  252.          "Chirp" is optional.  Screen Style is also indicated here.  The
  253.          line format is the default, and the orignal "block" format is
  254.          optional if the word "BLOCK" appears here as well.
  255. 18       The default "Return To" Directory Pathname.  This is usually "c:\"
  256. when Menu-Master is run in the Root Directory.  After exiting your applica
  257. tion, the batch file Menu-Master built will change to this drive and
  258. directory and look for the file called MENU.BAT
  259.  
  260. 19       Default Pathnames to search for called programs.  See your DOS
  261. Manual  for a complete description of how to use the Path Command.  When
  262. used, this selection overrides any Path parameters set up by other batch
  263. files, such as your AUTOEXEC.BAT file.  Entries must include the "\" and
  264. end with a semi-colon.  For example,"C:\DOS;D:\APP;" would be a valid
  265. entry.
  266.  
  267. 20       Menu name as it appears in the menu Title Bar.
  268.  
  269. 21 - 26  DOS Path and Application names used by Menu-Master to build the
  270. batch files to call the applications presented in fields 1 - 6. (the left
  271. side of the menu)
  272.  
  273. 27       Optional Password which, if present, will be required by Menu-
  274. Master before exiting to the Change Menu Names program. (selection [1] on
  275. the DOS Menu)  This password is case sensitive.  It must be entered in the
  276. same upper or lower case structure that you define when entering it here.
  277. As a precaution, wait until your menu system is functioning the way you
  278. want it to before entering anything here.  This eliminates your having to
  279. enter the password to make minor adjustments.
  280.  
  281. 28 - 33  DOS Path and Application names used by Menu-Master to build the
  282. batch files to call the applications presented in fields 8 - 13. (the sec
  283. ondary menu names on the right side of the menu.)
  284.  
  285. 35 - 36 Valid DOS Command names which correspond with menu entries 15 -16
  286. above.  Invalid command names will result in an error message when selected
  287. by the DOS Menu selections 5 or 6.  The system default for items 14 and 34
  288. is a Directory Display which calls the program MENUDIR.COM, which is NOT
  289. supplied with Menu-Master.  You may wish to use the IBM DIR command or any
  290. directory utility of your choice. (My favorite is DDIR.COM from PC Maga
  291. zine, which is available on almost every bulletin board or through PC-SIG).
  292. Simply copy it to the subdirectory containing Menu-Master with the new name
  293. of MENUDIR.COM.  The default directory may be changed or modified as
  294. selected.  You will be prompted on-screen and may select any valid
  295. directory.  (i.e.  instead of viewing the default directory you can get a
  296. double wide display of the items in \LOTUS\DATA by responding:
  297.  
  298. \LOTUS\DATA [Return] to the prompt presented after selecting #4.
  299.  
  300.  
  301. Other DOS Commands which may be useful include BACKUP, RESTORE, TREE, or
  302. COPY.   The entire command structure should be included, but cannot exceed
  303. the line limitation of 34 characters.  For example:
  304. Field 15 = Lotus Backup to A:
  305. Field 35 = BACKUP C:\LOTUS\DATA\*.* A:  (only 28 characters)
  306.  
  307.  
  308. 37       Foreground Color     -- see your Basic manual
  309. 38       Background Color     -- or refer to the color
  310. 39       Border Color         -- chart below.
  311.  
  312.  
  313.         Colors for use in 37-39
  314.  
  315. 0    Black                  8  Gray
  316. 1    Blue                   9  Light Blue
  317. 2    Green                 10  Light Green
  318. 3    Cyan                  11  Light Cyan
  319. 4    Red                   12  Light Red
  320. 5    Magenta               13  Light Magenta
  321. 6    Brown                 14  Yellow
  322. 7    White                 15  High Intensity White
  323.  
  324. Background colors must be between 0 and 7.  All color selections are
  325. ignored if your system is equipped with an IBM Monochrome Display Adapter.
  326. If however, you have a Color Graphics Adapter, EGA or VGA adapter, and use
  327. it with a monochrome display, the system will accept color choices.  For
  328. this reason, Menu-Master is shipped with black and white colors of 7,0,0
  329. installed.  Some color combinations are not readable with any display!
  330.  
  331.                SPECIFICATIONS FOR PATH AND APPLICATION NAMES
  332.  
  333. Configuration Page fields 21-33.  Most users of fixed disk systems divide
  334. the disk into directories which make it easier to find applications and
  335. data, especially when some application names may duplicate themselves
  336. between directories.  For this reason, the root directory should consist
  337. primarily of directories and, of course, your Menu-Master System files.  A
  338. nice clean Root Directory might look like our example in Figure 1 after you
  339. have loaded the Menu-Master files.
  340.  
  341. As users become more and more users and not computer experts, Menu-Master
  342. does all the set-up work involved in transitioning between directories and
  343. starting applications.
  344.  
  345.                      EXECUTING FILES IN SUBDIRECTORIES
  346.  
  347. In the example, all of the Lotus Files are in the directory called Lotus.
  348. When the menu choice of Lotus 1-2-3 is made, we need to change to the Lotus
  349. directory and call the program called LOTUS. Hence our Configuration Page
  350. entry begins with a "\LOTUS" which results in a change to the LOTUS direc
  351. tory and the entry "\LOTUS" which calls the program LOTUS.COM.  The entire
  352. entry then consists of "\LOTUS\LOTUS".  When the user enters the Quit Com
  353. mand to Lotus, the system returns to the menu display which called it as
  354. specified in configuration item #19, usually the root directory.
  355.  
  356.  
  357.  
  358.                     DIRECTORY CHANGE WITHOUT EXECUTION
  359.  
  360. Sometimes it may be desirable to change to a subdirectory without executing
  361. a program file.  This is easily done by specifying the directory name and
  362. a backslash with no program name.  For example "\LOTUS\" would result in a
  363. change to the directory called LOTUS and a display of the directory con
  364. tents with no program execution.  Used in this way Menu-Master must be
  365. recalled by entering the MENU command from the root directory.
  366.  
  367.  
  368.                   CALLING AN APPLICATION VIA A BATCH FILE
  369.  
  370. If your application is called from a batch file, all things change.  Noth
  371. ing Menu-Master can't handle, just a minor inconvenience which is easily
  372. accommodated.   Applications called via a batch file, like Menu-Master,
  373. must be specified on the Configuration Page as follows.   Assume that you
  374. wish to call Menu-Master which resides also within the sub-directory called
  375. "BASIC".  Just as before we set up the subdirectory and application name as
  376. "\BASIC\MENU", but now we follow this name with with its .BAT filename
  377. extension, or via a shorthand method, the vertical bar "|".  Our
  378. Configuration Page entry now becomes "\BASIC\MENU.BAT", OR "C:\BASIC\MENU|.
  379. This convention tells Menu-Master that it will be calling a batch file and
  380. Menu-Master constructs the calling batch file according to the appropriate
  381. DOS rules, which become transparent to the menu's user.
  382.  
  383.                      RETURNING TO THE MENU APPLICATION
  384.  
  385. When you have constructed all of your menu choices following these guide
  386. lines, simply press [Return] or [F-10] and you will see you own menu appear
  387. under your own title.  The Set-Up or Configuration choices have been saved
  388. and will be included next time your Menu-Master Menu appears.
  389.  
  390.                               EXITING TO DOS
  391.  
  392. You may exit from Menu-Master at any time when the menu screen is present
  393. by touching [F-10] or [Esc] twice in succession ( [Esc] to the DOS Menu
  394. side and [Esc] to Exit to DOS).  This convention is included to provide
  395. backwards compatibility with previous versions of Menu-Master, and
  396. keystroke recognition by remote access programs such as CarbonCopy. This
  397. will leave you in the directory established by Configuration Page item #19
  398. or the Root Directory.
  399.  
  400.                              OPERATIONAL NOTES
  401.  
  402. Some applications do dynamic things to memory boundaries and other operat
  403. ing system internals which may effect the way that other applications oper
  404. ate.  Microsoft Multiplan is an example of a program that changes the oper
  405. ating environment.  Other programs which are called by Menu-Master after
  406. the conclusion of a Multiplan session (for example) may behave in an unpre
  407. dictable fashion because they inherit their operating environment from the
  408. just terminated program.   (They would naturally behave in the same way if
  409. run without Menu-Master.)   The only way around this phenomenon is to "re-
  410. boot" the system causing Menu-Master to appear when called from the AUTO
  411. EXEC.BAT file.  Most well behaved programs of reasonably current vintage,
  412. however, will always return your machine to the state they found it in when
  413. exiting.  Menu-Master itself is NOT memory resident, and does NOT modify
  414. your operating environment in any fashion.
  415.  
  416. If you are installing Menu-Master in conjunction with PC-MOS/386 from The
  417. Software Link, be sure to install the menu for multiple users in multiple
  418. directories.  If multiple users attempt to access the same menu system,
  419. your system may lock until manually re-booted.
  420.  
  421. Images may become "burned-in" to a CRT Display, and remain visible even
  422. when the monitor is turned off.   In order to avoid the possibility of hav
  423. ing your menu permanently etched into your display screen, Menu-Master pro
  424. vides a user defined time-out period.  It is set as delivered for 240 sec
  425. onds or 4 minutes.  After 4 minutes the screen clears to a one-line
  426. reminder that it's soon to go away, and 60 seconds later the one-liner dis
  427. appears and the time, date and day-of-week display  will be shown on one
  428. line chosen by random selection on a black screen.  This will remind you
  429. that Menu-Master is alive and waiting for your next key depression as well
  430. as giving you a handy reference to the day and time.
  431.  
  432. If you have defined a secondary (right hand side) display menu, the name
  433. you defined appears as Main Menu selection #7.  It will also appear as DOS
  434. Menu #6.  This is to allow you to change menu screens easily without having
  435. to go back to the main menu.  The exception to this rule occurs when you
  436. have defined a DOS function in Configuration File item #36.  This function
  437. then appears in menu position #6 and you must return to the Secondary Menu
  438. through the Main Menu. (Selection #7)
  439.  
  440. You may always bring up the DOS Menu to the right side of the display by
  441. pressing [F-2], and exit to DOS from anywhere by touching [F-10].  The
  442. copyright screen appears when the system is started for the first time each
  443. day.  After that, you won't see it again until the following day unless you
  444. touch [F-5].  To get rid of it again, just touch any key.
  445.  
  446. The On Screen Function Key reminders will change, depending on whether or
  447. not you use all 7 positions of the Secondary menu or all 7 positions of the
  448. DOS Function Menu.   These may all be defined by the user and you will be
  449. prompted to return to the other available screens via Function Keys.
  450.  
  451. Because of the variances between different brands of color displays, it may
  452. be possible to adjust parameters 37-39 so that no display is produced on
  453. your monitor.  If this happens, use the audible chirp to change 37 to 7 and
  454. 38 & 39 to 0.  This will allow you to see the display again.  Pressing
  455. [Return] alone, or [F10] will save the display parameters and you won't be
  456. able to see the menu either.
  457.  
  458.  
  459.  
  460.                     REGISTRATION AND USER COMMENT FORM
  461.  
  462. Those of us at Blue Caboose Systems and Micro-Baron Software are
  463. continually striving to provide quality products at a most reasonable price
  464. in a User Supported format.  Please use the following form to register your
  465. product so that we may advise you as new enhancements to Menu-Master become
  466. available.  Product support will only be offered to those individuals with
  467. a registration form on file.
  468.  
  469. When we receive your registration, we will ship to you the most recent
  470. version of Menu-Master along with the most recent published and
  471. professionally printed documentation booklet in a fold-over binder.
  472. Registered copies also have the ability to modify the initial copyright
  473. screen to your own liking, customized for you or your company.
  474.  
  475.  
  476. NAME:_______________________________________________
  477.  
  478. PHONE:(____)_____-_______
  479.  
  480. ADDRESS:____________________________________________
  481.  
  482. CITY:_______________________STATE:_____ZIP:_________
  483.  
  484. COMPUTER BRAND:_____________________________________
  485.  
  486. CONFIGURATION:______________________________________
  487.  
  488. VERSION NUMBER:_________(from the copyright screen, touch [F-5])
  489.  
  490. COMMENTS AND SUGGESTIONS:
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515. ___User Supported $29.00 Registration Fee Enclosed.
  516.  
  517. ___Corporate Site-License fee of $200 enclosed.  Your agreement will be
  518. returned with the program binder and documentation.